Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Controlling Movie Playback

GoToBeginningOfMovie

The GoToBeginningOfMovie function repositions a movie to play from its start.

pascal void GoToBeginningOfMovie (Movie theMovie);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

If you have defined an active movie segment, the GoToBeginningOfMovie function repositions to the start of the active segment. The active movie segment is the part of the movie that your application is interested in playing. By default, the active movie segment is set to be the entire movie. You may wish to change this to be some segment of the movie--for example, if you wish to play a user's selection repeatedly. By setting the active movie segment, you guarantee that the Movie Toolbox uses no samples from outside of that range while playing the movie.

If the movie is in preview mode, the function goes to the start of the preview segment of the movie. In all other cases, this function moves you to the start of the movie, where the movie time value is 0.

SPECIAL CONSIDERATIONS

Movies need not be at the start position when they are saved. The Movie Toolbox stores a movie's time position in the movie when it is saved. If you want to play a movie from the beginning, your application should call the GoToBeginningOfMovie function before playing a movie you have loaded from a movie file.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can use the SetMovieActiveSegment and GetMovieActiveSegment functions to work with the active segment. For details, see "Enhancing Movie Playback Performance" beginning on page 2-119.